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ABSTRACT 


The  Element  File  Update  program  is  an  interactive  editor  for  the 
non-orbital  Master  Element  File  data.  Presented  here  are  a program 
overview,  specific  operating  instructions  and  special  user  and  programmer 
notes . 
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I.  OVERVIEW 


Element  File  Update  (ELUP)  is  an  interactive  editor  for  the  Master 
Element  File  (MEF)  data.  The  Element  File  Maintenance  (EFM)  task 
processes  routine  orbital  element  set  updates.  Non-routine  orbital 
element  set  editing  is  processed  by  the  interactive  satellite  ephemeris 
processor  SAT.  ELUP  maintains  the  remainder  of  the  MEF  record  described 
in  Table  1. 

The  MEF  is  the  storage  location  of  not  only  the  orbital  element  set 
data,  but  also  descriptors,  both  narrative  and  numeric,  of  the  satellite 
and  its  tracking  history.  It  provides  a single  control  point  for  satellite 
data.  The  file  is  in  two  parts:  a directory  called  the  Master  Index 
File  (MIF)  contains  a tabulation  of  the  satellite  numbers  and  the  record 
numbers  containing  the  MEF  data;  and  the  MEF,  containing  the  actual  data 
as  shown  in  Table  1.  Up  to  1000  satellite  entries  may  be  kept  on  the 
MEF. 

Additional  capabilities  include:  renumbering  satellite  records; 
replacing  the  "current"  orbital  element  set  for  a given  satellite  by  the 
previous,  or  "old"  set.  This  is  the  only  program  in  the  ETS  system 
which  can  delete  satellite  records  from  the  MEF. 
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TABLE  1 

STRUCTURE  OK  A MASTER  ELEMENT  FILE  IMEK)  RECORD 

• Satellite  Nunibe  r 

• Security  Class  1 1 ic.it  lun 

• Narrative  Tag 

• National  Origin 

• Spin  Vector 

• Reflectivity-Area  Product 

• Descriptors 

• Observed  Offsets 

0 Current  Orbital  Element  Set* 

• Previous  Orbital  Element  Set* 


*Not  editable,  except  for  the  element  set  number  of  the  current  set. 
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II.  OPERATION 

The  program  Is  activated  from  the  computer  operator's  console  by 
typing: 

/ELUP/ACT, ,TM 

It  erases  the  CRT  screen  at  the  user's  terminal,  writes  Its  name, 

[ • 

version  ID  and  the  current  day/date/time  on  the  screen,  writes  a prompting 
question  mark  and  awaits  user  input. 

! 


III.  COMMAND  STRUCTURE 


ELUP  la  command  atructured  with  free  format  Input.  All  commands 
may  be  abbreviated  by  their  first  three  characters.  Characters  after 
the  third  are  Ignored.  Fifteen  commands  are  available.  For  most  commands 
the  arguments  may  either  be  typed  on  the  same  line  as  the  command  or 
entered  separately.  The  TAG  and  METrlc  commands  require  some  special 

attention,  as  will  be  discussed  below.  • 

The  form  of  a typical  command  line  la: 

« 

COM  argl .... ,argn 

As  noted  above,  the  conmand  field  "COM"  In  this  example,  must  be  at 
least  three  characters  long.  The  arguments  may  be  separated  by  a comma, 
an  equal  sign,  a slash,  or  one  or  more  spaces.  A space  cannot  be  used 
In  conjunction  with  any  of  the  other  separators  because  the  system 
interprets  this  as  a null  (zero)  argument.  Table  ? tabulates  the  commands 
and  gives  a synopsis  of  their  use. 


IV . COMMANDS 


The  most  common  use  of  the  program  is  to  edit  the  MEF  record 
for  a given  satellite.  Before  editing  can  begin,  the  MEF  record 
for  that  satellite  must  be  fetched  from  disk.  Three  commands  will 
fetch  the  MEF  record.  These  ars  Display,  EDIt  and  FINd.  The  principal 
difference  between  Display  and  EDIt  is  that  the  former  lists  the 

record(s)  fetched  on  the  current  output  device,  while  the  latter  lists  « 

the  record  fetched  on  the  CRT  terminal.  The  FINd  command  helps  you 
locate  a satellite  whose  tag  (name)  you  remember  but  whose  number  you 
can't  recall. 

When  editing  any  piece  of  data  (where  the  data  is  not  typed  on  the 
same  line  as  the  command) , typing  $$  causes  the  current  transaction 
to  be  terminated  without  affecting  the  MEF  record.  Whether  the  data  is 
entered  on  the  command  line  or  separately  any  piece  of  data  you  do  not 
wish  to  change  can  be  protected  by  typing  an  asterisk  (*)  in  its  position 
in  the  argument  list. 

In  the  command  description  below,  required  inputs  are  in  upper  case; 
optional  inputs  and  argument  paraforms  are  in  lower  case;  optional  arguments 
are  enclosed  in  left  and  right  carets.  Figure  1 shows  the  MEF  record  listing 
format  generated  by  the  program.  Note  that  the  second  record  was  deleted 
during  the  operating  session. 

A.  Displaying  MEF  Records 

Display  <sat  <lt rec» 

Sat  is  the  optional  (first)  satellite  number  to  be  listed 

// rec  is  the  optional  number  of  records  to  be  listed 


6 


DAY  324, 


ELEMENT 
20  NOV  78 


FILE 

10:41 


UPDATE 


4,1 


78066  D ROCKET  BODY  OF  COSMOS  1024 
USSR  RhO*A-  1.00  SPIN-  0.00  0.00  0.00 

CYLINDER  NOT  MANEUVERABLE 

LAST  OFFSETS:  T=  0.00  &RA-  0.00  &DEC- 

1 10998U  78066  D 78305.22164658  -.00001118 

2 10998  62.8488  251.8013  7332425  319.5754 

1 10998U  78066  D 78283.71894066  -.00000117 

2 10998  62.8380  254.9107  7340348  319.3161 


REC.fi> 

79 

1 

0.00 

&T-  0.00  MIN. 

12 

4.5140 

1.99971050 

10 

4.2806 

1.99982788 

****  SAT.//  95002.0  DELETED  **** 


10NU  STAL 
RH0*A-  1.00 

CURRENT  OFFSETS: 

1 95002U  IONU 

2 94002  4.1480 

1 95002U  IONU 

2 95002  63.3042 


SPIN-  0.00  0.00  0.00  REC . If  463 

0 

T-  0.00  &RA-  0.00  &DEC-  0.00  &T-  0.00  MIN. 

78242.83133137  0.00000000  0 

70.6543  0167886  214.3001  248.2377  1.01620010 
78320.04166666  0.00000000  0 

147.6737  6963997  279.7500  344.4238  2.00507706 


Fig.l.  MEF  records  displayed  by  ELUP. 
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If  no  arguments  are  input  the  current  record  is  displayed. 

If  sat  ■ 1,  display  the  next  record. 

If  sat  - -1,  display  the  first  record. 

0<  0 rec  < 100 

Records  are  displayed  on  the  current  OUTput  device.  The  (last) 
record  displayed  is  available  for  editing. 

B.  Editing  by  Satellite  Number 
EDIt  <sat> 

SAT  is  the  optional  satellite  number  to  be  edited. 

Conventions  for  sat  are  the  same  as  for  Display. 

If  sat  is  specified,  the  MEF  record  retrieved  is  displayed  on  the 
CRT  screen. 

C.  Finding  Satellite  Record  by  Tag 
FINd  stringl. . .stringn 

strlngl . . .stringn  are  four-character  strings  to  be  located  consecutively 
and  exactly  in  a satellite  tag.  Searching  begins  at  the  next  record  on  the 
MEF.  If  an  ASCII  field  exceeds  4 characters,  only  the  first  four  are 
checked.  Numeric  fields  of  the  tag  are  compared  for  numeric  equality. 

The  record  found  is  available  for  editing. 

D.  Specifying  the  Output  Display  Device 
OUTput  <unit> 

unit  - ADD<s>  for  the  CRT  screen 
- LP  for  the  printer  file 
■ TY  for  the  console  teletype 

If  no  argument  is  input  the  current  output  device  name  is  listed. 
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K.  List  Ing  the  Command  Abbreviations 

COMmands 

i'lte  listing  is  on  the  CRT  screen. 

F.  Editing  the  Metric  (Numeric)  Data 

METric 

Issuing  this  command  causes  the  program  to  enter  a two-stage 
edit  of  the  ancillary  numeric  data  in  the  current  MEF  record.  Editing 
convent  lot  s are  described  above. 

Stage  1 edits  the  reflectivity-area  product  (RHO*A) , the  spin 
vector  (dimensioned  3)  and  the  element  set  number.  The  current  data  is 
listed  before  new  data  is  requested.  RHO*A  must  be  greater  than  aero. 

(It  is  area  times  reflectivity.)  The  spin  components  are  right  ascension, 
declination  of  the  spin  axis  and  the  angle  between  the  spin  axis  and  the 
axis  of  symmetry  (all  in  degrees). 

Stage  2 edits  the  descriptor  information.  Table  3 presents  the  set 
of  descriptor  values  which  are  currently  assigned.  This  admittedly 
complicated-to-remember  structure  is  written  on  the  screen  before  the  data 
is  requested.  Editing  conventions  are  described  above. 

C.  Editing  the  Narrative  Tag 

TAC  <narrative^ 

if  narrative  is  specified  on  the  command  line,  it  must  begin  in 
column  “>.  If  it  is  not  specified  on  the  command  line,  the  current  tag 
is  listed  and  the  narrative  tag  prompted.  The  tag  should  begin  in 
Column  1.  The  first  8 characters  of  the  tag  are  the  international  name. 
They  are  write  protected. 
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TABLE  3 


DESCRIPTOR  ASSIUNMKNTS 


Word  1 - Shape  Word  2 - Status  Word  3 - Update 


unknown 

0 

unknown 

0 

observed  on  current 
elements 

flat  plate 

1 

not  capable  of 
maneuver 

1 

new  SDC  elements 
since  observed 

cylinder 

2 

capable  of 
maneuver 

>1 

//  times  propagated 
(+1) 

sphere 

3 

not  tasked  for 

ETS  observation 

A 3-axis 
stabilized 
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H.  National  Origin 


ORIgin  <nation'> 

nation  is  the  four  character  ASCII  code  for  the  nation  of  origin  of 
the  satellite. 

If  no  argument  is  input  the  current  national  origin  is  listed  and 
the  new  data  prompted. 

I.  Observed  Offsets 
OFFsets  <day,  ra,  dec,  time> 

day  is  the  floating  point  day  (and  fraction)  of  the  last  observation 

ra  is  the  offset  right  ascension  (degrees) 

dec  is  the  offset  declination  (degrees) 

time  is  the  offset  time  (minutes)  along  orbit 

J.  Security  Classification 
CLAssif ication  <UCS> 

UCS  = U for  unclassified  elements 
C for  confidential  elements 
S for  secret  elements 

K.  Deleting  Satellite  Records 
DELete  sat 

sat  is  removed  from  the  index  file  and  its  MEF  record  purged.  The 
file  is  compressed  and  resequenced  automatically  at  program  termination. 
See  the  User  Notes  for  details.  A message  and  historical  listing  of  the 
record  being  deleted  is  sent  to  the  printer  file. 
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L.  Recovering  Previous  Element  Set 

PULI  sat 

The  "old"  element  set  in  the  two  set  stack  is  written  over  "current" 
element  set.  This  is  typically  done  when  the  new  set  Is  determined  to  he 
invalid,  for  some  reason.  If  no  "old"  set  exists  an  error  message  is 
generated. 

M.  Re-numbering  an  MEF  Record 

NlIMber  old//,  new II 

old#  is  the  number  of  the  satellite  on  the  MEF  whose  satellite 
number  is  to  be  changed. 

new#  is  the  number  to  which  it  is  to  be  changed. 

This  feature  can  be  used  to  correct  index  file  or  data  entries 
which  do  not  match,  renumber  analyst-generated  records,  or  to  protect 
records  from  being  over-written  by  Incoming  orbital  element  set  updutes. 

N.  Listing  the  Number  of  Objects  on  File 

STAtus 

This  lists  on  the  CRT  screen  the  number  of  occupied  MEF  records. 

O.  Program  Termination 

EXIt 
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V.  USER  NOTES 


> 


i 


{ 


* 


A.  Editing 

Editing  of  an  MEF  record  is  on  a continuous  update  basis.  Each 
edited  piece  of  data  is  placed  in  the  element  set  record  and  re-written 
to  the  MEF.  Thus,  if  the  program  should  abnormally  cease  execution  nearly 
all  the  editing,  except  perhaps  the  last  piece  of  data,  would  be  up  to  date. 

B.  Special  Processing 

If  a NUMber  request  is  received,  the  program  will  rewrite  the  index  file 
to  disk  at  termination  time.  If  a DELete  request  is  received,  the  index  file 
is  rewritten  and  the  Element  File  Resequence  program  MEF  is  run  as  an  overlay 
to  compress  and  resequence  the  MEF. 

C.  Admonitions 

The  three  commands  of  execution  DELete,  PULI  and  NUMber  are  not  to 
be  taken  lightly.  Deletions  are  immediate  and  non-recoverable . PULls 
overwrite  the  current  orbital  elements  and  are  non-recoverable.  NUMber 
can  cause  an  element  set  to  be  hidden  in  that  no  one  except  the  originator 
will  know  where  the  satellite  data  is  stored.  These  commands  should  only 
be  used  by  experienced  orbital  analyst  personnel. 
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